home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / print / gsview10.zip / gsview.doc < prev    next >
Text File  |  1993-07-29  |  34KB  |  835 lines
  1. 1Overview
  2. ?Overview
  3.  `Ghostview for Windows` is a graphical interface for MS-Windows `Ghostscript`.
  4.  Ghostscript is an interpreter for the PostScript page description language
  5.  used by laser printers.
  6.  For documents following the Adobe PostScript Document Structuring
  7.  Conventions, Ghostview for Windows allows selected pages to be viewed or
  8.  printed.
  9.  Ghostview for Windows can be used with Windows Ghostscript 2.6 or later.
  10.  Ghostview for Windows was inspired by Tim Theisen's X11 Ghostview
  11.  program.
  12.  The ability to understand `DSC` comments comes from X11 Ghostview.
  13.  
  14. 2Document Structuring Conventions
  15. ?Document Structuring Conventions
  16. ?DSC
  17. ?Encapsulated PostScript
  18. ?EPSF
  19. ?EPS
  20.  Adobe has defined a set of extended comment conventions that provide
  21.  additional information about the page structure and resource
  22.  requirements of a postscript file.
  23.  If a file contains these Document Structuring Convention (DSC) comments,
  24.  Ghostview can display pages in random order using `Goto` and display pages
  25.  in reverse order using `Prev`.  Selected pages can be extracted to
  26.  another file or printed.
  27.  
  28.  If a file does not contain DSC comments, Ghostview can only
  29.  display the pages in the original order.
  30.  
  31.  DSC conforming files start with the comment line:
  32.   %!PS-Adobe-3.0
  33.  where the number 3.0 may change and is the DSC version number.
  34.  Some programs write postscript files with a control-D as the first
  35.  character of the file, followed by the comment line mentioned above.
  36.  Ghostview will correctly report that these files are not DSC conforming,
  37.  but will still display them with page selection features available.
  38.  Complain to the author of the program that produced the postscript file.
  39.  To make the file DSC conforming, edit it to remove the control-D character.
  40.  
  41.  DSC conforming files contain lines such as:
  42.   %%Pages: 24
  43.   %%Page: 1 1
  44.  These lines tell Ghostview how many pages a document contains and
  45.  where they start.  Ghostview uses this information to select
  46.  individual pages.
  47.  
  48.  Encapsulated PostScript Files (EPSF) are single page documents
  49.  that contain a subset of the `DSC` comments and PostScript commands.
  50.  EPS files start with the comment line:
  51.   %!PS-Adobe-3.0 EPSF-3.0
  52.  EPS files are commonly used for inclusion in other documents and
  53.  for this reason require the bounding box comment:
  54.    %%BoundingBox: llx lly urx ury
  55.  where llx, lly, urx and ury are integers giving the x and y coordinates
  56.  of the lower left and upper right corners of a bounding box which encloses
  57.  all marks made on the page.
  58.  
  59.  Some EPS files contain a preview of the postscript document.
  60.  This preview can be a Windows Metafile, a TIFF file, or an Interchange
  61.  preview (EPSI format).
  62.  For the Windows Metafile or TIFF file preview, the EPS file under DOS
  63.  contains a binary header which specifies the location and lengths of
  64.  the preview and postscript language sections of the EPS file.
  65.  For the Interchange format, the preview is contained in DSC comments
  66.  starting with
  67.   %%BeginPreview: width height depth lines
  68.  An EPS file with a preview can be created from an EPS file without a
  69.  preview using `Add EPS Preview`
  70. 2Opening a Document
  71. ?File
  72. ?Open
  73. ?Select File
  74. ?Close
  75.  The `Open` command on the `File` menu opens a file and displays
  76.  the first page.
  77.  
  78.  If the file contains `DSC` comments, pages can be selected using
  79.  `Next`, `Prev` and `Goto`.
  80.  
  81.  If the file does not contain `DSC` comments, `Prev` and `Goto` will
  82.  not work.  Another file should not be selected until a last page of
  83.  the file has been displayed.
  84.  
  85.  When a file is open, Ghostview will display the document filename,
  86.  the current page (if available) and while the cursor is over
  87.  the image, the location of the cursor in default user coordinates
  88.  (1/72 inch).
  89.  The cursor location is useful for calculating bounding boxes.
  90.  
  91.  The `Select File` command is similar to `Open` but it does not display
  92.  the document.
  93.  This command is useful for opening a document prior to printing it.
  94.  
  95.  The `Close` command closes the currently open document.
  96.  This should be used before the current file is changed by another
  97.  program.
  98.  If you do not do this and Ghostview detects that the file length or date
  99.  have changed, it will close Ghostscript and rescan the document.
  100.  
  101.  See also `Print`.
  102. 2Page Selection
  103. ?Page Selection
  104. ?Next
  105. ?Prev
  106. ?Redisplay
  107. ?Goto
  108.  `Next` moves to the next page of a document.
  109.  This works even if the document does not contain `DSC` comments.
  110.  
  111.  `Prev` moves to the previous page.
  112.  
  113.  `Redisplay` redisplays the current page.
  114.  
  115.  `Goto` shows a dialog box which allows selection of the next page
  116.  number to display.  The `Select Page` dialog box shows page labels
  117.  since these are likely to be more useful than a sequential page number.
  118.  
  119.  The `Prev`, `Redisplay` and `Goto` commands work only if the
  120.  document contains `DSC` comments.
  121. 2Document Information
  122. ?Info
  123.  A brief information area at the top of the window is used by
  124.  Ghostview to display the document filename, the current page number
  125.  and label (if available) and while the cursor is over the image, the
  126.  location of the cursor in default user coordinates (1/72 inch).
  127.  The cursor location is useful for calculating bounding boxes.
  128.  
  129.  The `Info` command on the `File `menu shows a dialog box with the
  130.  following information about the `DSC` comments in the current document.
  131.  
  132.  `File `is the full pathname to the document.
  133.  
  134.  `Type` is` DSC`,` EPS` or `No DSC comments`.
  135.  `EPS` is an Encapsulated PostScript File - a single page document
  136.  that contains a subset of the `DSC` comments and PostScript commands.
  137.  `EPS `files are commonly used for inclusion in other documents.
  138.  
  139.  `Title` is a text title that can be used when printing banner
  140.  pages and for routing or recognising documents.
  141.  
  142.  `Date` is the time the document was created.
  143.  
  144.  `BoundingBox` specifies a box that encloses all the marks painted
  145.  on the page.  The four integer values are the coordinates of the
  146.  lower left and upper right corners of the bounding box in default
  147.  user coordinates (1/72 inch).
  148.  
  149.  `Orientation `is either `Portrait `or` Landscape`.
  150.  
  151.  `Default Media` gives the media name followed by the width and
  152.  height of that media in default user coordinates (1/72 inch).
  153.  
  154.  `Page Order` is either `Ascending`, `Descending` or `Special`
  155.  
  156.  `Pages` is the total number of pages in the document.
  157.  
  158.  `Page` gives the page label and page number.
  159.  
  160.  `Bitmap `is the size of the display bitmap in pixels which may be
  161.  useful if you are copying the displayed image to the clipboard.
  162. 2Printing
  163. ?Print
  164. ?Print To File
  165. ?Print File
  166. ?Extract
  167.  The `Print` command on the `File `menu allows printing of the document
  168.  using Ghostscript.
  169.  The Ghostscript printer driver and resolution are selected using the
  170.  `Select Device` dialog box.   Pages are selected using the `Select Pages`
  171.  dialog box.  The `All`, `Odd` and `Even` buttons provide quick selection
  172.  of pages.
  173.  
  174.  The `mswinprn` printer driver uses the windows printer drivers
  175.  and should work with any printer with raster capabilities.
  176.  Printer resolution cannot be selected from within Ghostview; use
  177.  the Control Panel instead.  This driver is very slow.
  178.  
  179.  With all other printer drivers, Ghostscript sends the output direct
  180.  to the printer, without passing through a Windows printer driver.
  181.  If you have trouble printing you may have to `Print To File`
  182.  and then `Print File` or use the DOS command `COPY /B FILENAME PRN`.
  183.  
  184.  This list of available devices and resolutions is stored in the
  185.  [Devices] section of gsview.ini.  The default list of devices
  186.  and resolutions is taken from the standard distribution version
  187.  of Ghostscript for Windows 2.6 and may not be complete.
  188.  
  189.  To print a document without displaying it, open the document
  190.  using `Select File`.
  191.  
  192.  `Print To File` is similar to the `Print` command except that Ghostscript
  193.  will write the output to a file instead of sending it to a printer.
  194.  
  195.  If you want to produce a bitmap, some useful drivers are
  196.  `bmpmono`, `bmp16`, `bmp16m` and `bmp256`.
  197.  
  198.  `Print File` sends a file to a local port, bypassing the W